home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1997 #4 / Amiga Plus CD - 1997 - No. 04.iso / pd / musik / syx10 / syx.doc < prev    next >
Text File  |  1997-01-15  |  5KB  |  139 lines
  1.  
  2. - SyX - Amiga MIDI System Exclusive dump utilitiy
  3.  
  4. Release date: 15-01-1997
  5.  
  6.  
  7. - What is SyX?
  8.  
  9. SyX is a MIDI utility that can record, transmit and save MIDI System
  10. Exclusive data. It can receive multiple messages, what is usefull for synths
  11. that send more than one SysEx message in a Bulk Dump. 
  12. When transmitting the SysEx data, you can set a delay between bytes and/or
  13. messages. Some synths, like the Roland MC303 require this in order to
  14. receive the messages correctly.
  15.  
  16.  
  17. - Copyright and stuff
  18.  
  19. SyX is copyrighted 1997 by Thijs van der Vossen. It may be freely used and
  20. distributed as long as all the original files are included. I am not
  21. responsible for any damage due to the use of this program whatsoever.
  22.  
  23. If you have questions, suggestions, bug-report or you simply want to tell me
  24. that you like this program, you can e-mail me at: T.Vossen@mail.uva.nl
  25. Also try the SyX homepage for updates: http://huizen.dds.nl/~tvdv/SyX.html
  26.  
  27. I would like to thank Sander, Joris, Laurens and Jonathan for beta-testing
  28. SyX. Thanx guys!
  29.  
  30.  
  31. - Requirements
  32.  
  33. You will need OS 2.0 or greater to run SyX. It also needs the Req.Library
  34. for the filerequester. This library is included in the archive. You also of
  35. course need a MIDI interface and some sort of MIDI equipment.
  36. SyX has been developed on a standard A1200 using BlitzBasic and has been
  37. tested on several other Amiga's configurations.
  38.  
  39.  
  40. - Installation
  41.  
  42. If you don't have the Req.Library present in your LIBS: directory, you have
  43. to copy it. This can be done automatically by clicking the install-SyX icon.
  44.  
  45.  
  46. - How to use it?
  47.  
  48. Press the Rec button to record some messages. If all the messages are
  49. recorded, press Stop. Use the project menu to save the messages in one big
  50. file that can be loaded later. To transmit the buffer, press Play.
  51.  
  52. If the buffer is too small, you can set a new buffersize by typing a new
  53. number in the BuffSize: gadget. You can empty the buffer by pressing Clear.
  54.  
  55. There are two delay gadgets, where you can type the amount of delay. You can
  56. set delay between bytes (don't do this, this is *very* slow!) and between
  57. messages (20 for the Roland MC303).
  58.  
  59.  
  60. - Buttons and gadgets
  61.  
  62. Rec (keyboard shortcut: r) - SyX will start recording the incoming SysEx
  63. messages. If all the messages are recorded, press Stop to end the recording.
  64. If SyX receives more bytes than the buffer can hold, it will display an
  65. error message. Any last incomplete message will then be removed. This also
  66. happens when you press stop in the middle of recording a message. SyX never
  67. stores a incomplete SysEx message.
  68.  
  69. Play (keyboard shortcut: p) - SyX will start transmitting all the messages
  70. that are currently stored in the buffer. it will display the number of the
  71. message currently being transmitted. You can end the playback by pressing
  72. Stop.
  73.  
  74. Stop (keyboard shortcut: s) - Ends the recording or playback of SysEx
  75. messages.
  76.  
  77. BuffSize: - The buffersize gadget displays the size of the buffer. You can
  78. change this by typing a new number in the gadget and pressing return. The
  79. mimimum buffersize is 16. The maximum size depends on the amount of free
  80. memory. If you type a number that is too high, SyX will allocate a buffer of
  81. maximum possible size.
  82.  
  83. Clear (keyboard shortcut: c) - SyX will clear the buffer.
  84.  
  85. Bytes: - This gadget displays the number of MIDI bytes stored in the buffer.
  86.  
  87. Dly: (bytes delay) - Here you can type a number to set a delay between the
  88. transmitted bytes. Delays are in units of 20ms. ATTENTION! Setting a delay
  89. between bytes makes the playback of SysEx data *very* slow. I do not know
  90. any piece of MIDI equipment that needs this, so don't use it unless you
  91. really think it is needed.
  92.  
  93. Messages: - This gadget displays the number of MIDI messages stored in the
  94. buffer.
  95.  
  96. Dly: (messages delay) - Here you can type a number to set the delay between
  97. transmitted SysEx messages. For use with the Roland MC303, it should be set
  98. to 20. Most other synths will work with a zero delay.
  99.  
  100.  
  101. - Menu items
  102.  
  103. Load - loads a SysEx file.
  104.  
  105. Save As - Let you select a name and saves the buffer to disk. SysEx uses a
  106. raw format for it's files. This means that the MIDI bytes are saved to disk
  107. in exactly the same way that they are received and that no header is added
  108. to the file. This format is also used by SysExpert and most other dump
  109. utilities. SysEx files that you find on internet are usually also in this
  110. format. I recommend a .syx extension for your files (SYstem eXclusive).
  111.  
  112. Save - Saves the file. If no filemame has been selected, a error message
  113. will be displayed.
  114.  
  115. MIDI - This toggles the MIDI port. If you select this, the serial port can
  116. be used by other programs. SyX will display the message 'Serial port now
  117. free...' and you can no longer record of play SysEx data. Select it again to
  118. enable MIDI once again.
  119.  
  120. About (keyboard shortcut: Help) - Displays the about and help window.
  121.  
  122. Quit - Well, sort of exits the program.
  123.  
  124.  
  125. - Future Updates
  126.  
  127. Any future updates can be downloaded from the SyX homepage, so be sure to
  128. check it out once in a while. Some things that could be included:
  129.  
  130. - OctaMED SysEx fileformat support.
  131. - Tooltypes in the icon to set the buffersize, delays and directory.
  132. - CLI usage.
  133. - Load, Save and About buttons in the window.
  134. - ARexx port.
  135.  
  136. Let me know what you like most! Other sugggestions are also welcome. 
  137. e-mail: T.Vossen@mail.uva.nl
  138. SyX homepage: http://huizen.dds.nl/~tvdv/SyX.html
  139.